home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / tcp / AmiTCPsesn1_1.lha / AmiTCP_session-1.1 / README
Text File  |  1995-06-16  |  6KB  |  176 lines
  1. AmiTCP_session, written by David Jameson (dave@freeside.thegap.com)
  2. Version 1.1, released 17 June 1995.
  3. Based on AmiTCP_dialup by K. Raquel Sanborn (which was based on a
  4. script by P. Josh Rovero, which was based on a script by Dave Bolen).
  5.  
  6. HISTORY
  7.     Version 1.0 released 6th August 1994.
  8.  
  9.     Version 1.1 released 17 June 1995.
  10.     - Some minor bugs fixed.
  11.     - nowait option added
  12.     - Now outputs text sent back from modem
  13.  
  14.  
  15. REQUIREMENTS
  16.     Workbench 3.0 or above,
  17.     A modem,
  18.     A dial-up SLIP connection.
  19.  
  20.  
  21. INTRODUCTION
  22.  
  23.     This program is an Arexx script which starts up AmiTCP, dials up
  24.     a terminal server, sends outgoing mail and news, logs the time
  25.     online, and then hangs up the modem.
  26.  
  27.     Unlike AmiTCP_dialup, this program works with a terminal server
  28.     which uses static IP allocation (i.e. one where you don't get 
  29.     allocated a new IP address each time you log in).
  30.  
  31.     Also included in this archive is a script called "purge.rexx" which
  32.     deletes old news articles.
  33.  
  34.  
  35. INSTALLATION
  36.  
  37.     [1]    You must have the following programs installed before running
  38.         this script:
  39.     
  40.     *    AmiTCP version 2.3 (comm/net/AmiTCP-bin-22.lha and 
  41.              AmiTCP-22to23.lha)
  42.  
  43.     *    inetutils version 1.4 (comm/tcp/IU-14-amitcp.lha)
  44.  
  45.         *    breakname version 37.2 (util/cli/BreakName372.lha)
  46.  
  47.     It may work with newer versions of Inetutils and AmiTCP, but
  48.     you'll probably have to change some things in the script.
  49.  
  50.     [2] protect c/#? +s
  51.         copy c/#? to amitcp:bin/
  52.  
  53.     [3]    copy libs/#? to libs:
  54.       (unless you have newer versions of these libraries)
  55.  
  56.     [4]    makedir uunews:NNTPSpoolDir
  57.       (this is where outgoing netnews articles will be stored)
  58.  
  59.     [5]    Tell your news reader to use the nntpcopy program to send
  60.       outgoing news articles.  Nntpcopy simply copies the news
  61.     article into the directory uunews:NNTPSpoolDir, creating a
  62.     unique name for the file.  Any articles in this directory are
  63.     then sent to the NNTP server when AmiTCP_session is run.
  64.  
  65.     If you are using the Tin newsreader, set the environment
  66.     variable TIN_POST to "nntpcopy.rexx %s".  This can be done by
  67.     putting the following line in your user-startup file:
  68.  
  69.     setenv TIN_POST "nntpcopy.rexx %s"
  70.  
  71.     [6] Change the constants at the beginning of 
  72.         amitcp:bin/AmiTCP_session.rexx.
  73.       You need to fill in the phone number, username, password,
  74.     name of logfile, name of NNTP server, serial port speed,
  75.     the name of the active file and the name of the SLIP device.
  76.  
  77.     The active file should be set to "uulib:active" if you use
  78.     the Tin newsreader, or "uunews:active" if you use GRn.
  79.  
  80.     The script logs the time online in the same format as Ncomm, 
  81.     and by default it stores the log information in ncomm:ncomm.log 
  82.     (change this to something else if you don't have Ncomm installed, 
  83.     or to something like ram:logfile if you don't want a permanent log).
  84.  
  85.     [7]    Make sure your modem has "DTR override" enabled.  This is so
  86.         that the modem doesn't hang up when the Amiga drops DTR
  87.     (which happens when the serial.device is closed).  This
  88.     usually involves setting a DIP switch on the back of the
  89.     modem.
  90.  
  91.     
  92.     If you're having trouble, check to make sure your configuration
  93.     files are set up properly.  My s:uuconfig file looks like this:
  94.  
  95.     SMTPMailDir    uumail:
  96.     LogFile    uulib:logfile
  97.  
  98.  
  99.     My environment looks like this:
  100.  
  101.     SMTPRoute    SMARTERHOST
  102.     DomainName    .TheGAP.Com
  103.     HOME    uunews:
  104.     HOST    Freeside
  105.     HOSTNAME    Freeside
  106.     NNTPSERVER    news.gpl.net
  107.     SMTPMailDir    uumail:
  108.     SMTPSmarterHost    mailhost.thegap.com
  109.     TIN_MAIN    smtppost -Q <%s
  110.     TIN_POST    nntpcopy.rexx %s
  111.     USER    dave
  112.     USERNAME    dave
  113.     NodeName    Freeside
  114.     SENDMAIL    smtppost -Q
  115.     SMTPHOST    mailhost.thegap.com
  116.     SMTPRMAIL    SMTPpost -r
  117.     SMTPSpoolDir    uumail:SMTPSpoolDir/
  118.  
  119.     The following assigns are in my s:user-startup:
  120.  
  121.     assign inet:    amitcp:
  122.     assign uulib:   amitcp:UUCP
  123.     assign uumail:  uulib:Mail
  124.     assign uunews:  uulib:News
  125.     assign uuspool: uulib:Spool
  126.  
  127.  
  128. USAGE
  129.  
  130.     To run the program, simply type "AmiTCP_session.rexx".  If successful,
  131.     the program should connect to the terminal server and begin
  132.     transferring mail and news.  It will then bring up a requester,
  133.     which, when clicked on, will end the AmiTCP session and hang up the
  134.     modem.  
  135.  
  136.     If you simply want to transfer mail and news and then quit, without
  137.     bringing up a requester, type "AmiTCP_session.rexx nowait".  Be
  138.     careful using this option: if you're not online for very long, you 
  139.     might not pick up any incoming mail (i.e. the program might log off
  140.     before your service provider's machine has opened up an SMTP
  141.     connection).
  142.  
  143.     To use the news purger, type "purge.rexx <active_file> <days>" where 
  144.     <active_file> is the name of the active file and <days> is the
  145.     number of days to keep news articles for, e.g. "purge uulib:active 3"
  146.     will delete articles more than 2 days old (articles will be kept if
  147.     their creation date is today, yesterday, or the day before -- 3 days
  148.     in total).  This script has a few limitations: it doesn't update the
  149.     low article numbers in the active file, and it doesn't check the
  150.     articles for "Expires:" lines.
  151.  
  152.  
  153. DISTRIBUTION
  154.     This set of programs is public domain.  Do whatever you want with them!
  155.  
  156.  
  157. DISCLAIMER
  158.     The author is not responsible for any disasters which occur while
  159.     using these programs.
  160.  
  161.  
  162. ACKNOWLEDGEMENTS
  163.  
  164.     K. Raquel Sanborn for AmiTCP_dialup
  165.  
  166.     Michael B. Smith for INetUtils
  167.  
  168.     Mark Tomlinson and Geoff McCaughan for the Amiga version of Tin
  169.  
  170.     Kai Iske for breakname
  171.  
  172.     Joseph Stivaletta for rexxserdev.library
  173.  
  174.     And most of all, thanks to the authors of AmiTCP!
  175.  
  176.